Developer Documentation

QuickTime 4 API Documentation

Wired Movies and Sprites

| Previous | Chapter Contents | Chapter Top | Next |

New Grammar for Specifying String Parameters to Actions and Operands

QuickTime 3 supported only leaf data constants for string parameters. In QuickTime 4, you can specify string parameters using leaf data constants, a numeric expression, or a sprite track variable.

Expressions are converted to strings, as are sprite track variable s if they contain a floating-point number instead of a string. Note that although string variables are stored as C strings, they will be automatically converted to Pascal strings as needed.

This applies to the following action and operand parameters:

    C String Parameters
        kActionGoToURL, 1
        kActionStatusString, 1
        kActionAddChannelSubscription, 2    
        kActionAddChannelSubscription, 3
        kActionRemoveChannelSubscription, 1
        kOperandSubscribedToChannel, 1
        
    Pascal String Parameters
        kActionMovieGoToTimeByName, 1
        kActionMovieSetSelectionByName, 1
        kActionMovieSetSelectionByName, 2
        kActionPushCurrentTimeWithLabel, 1
        kActionPopAndGotoLabeledTime, 1
        kActionDebugStr, 1
        kActionAddChannelSubscription, 1


    Extended Grammar:
        [(C String Parameter)] =
                [CString]
            OR
                [(ExpressionAtoms)]
            OR
                [(SpriteTrackVariableOperandAtoms)]
                
        [(Pascal String Parameter)] =
                [Pascal String]
            OR
                [(ExpressionAtoms)]
            OR
                [(SpriteTrackVariableOperandAtoms)]
                
        
        [(SpriteTrackVariableOperandAtoms)] =
            <kOperandSpriteTrackVariable>, 1, 1
                [(ActionTargetAtoms)]
                kActionParameter, 1, 1
                    [(spriteVariableID)]
                    OR
                    [(ExpressionAtoms)] 


© 1999 Apple Computer, Inc.

| Previous | Chapter Contents | Chapter Top | Next |